home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3n / bind.z / bind
Encoding:
Text File  |  1998-10-20  |  6.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbiiiinnnndddd((((3333NNNN))))                                                              bbbbiiiinnnndddd((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _bbbb_iiii_nnnn_dddd - bind a name to a socket
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.  
  14.      _bbbb_iiii_nnnn_dddd_((((_iiii_nnnn_tttt _ssss_,,,, _cccc_aaaa_dddd_dddd_rrrr______tttt_rrrr _nnnn_aaaa_mmmm_eeee_,,,, _iiii_nnnn_tttt _nnnn_aaaa_mmmm_eeee_llll_eeee_nnnn_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _bbbb_iiii_nnnn_dddd() assigns a name to an unnamed socket.  When a socket is created
  18.      with _ssss_oooo_cccc_kkkk_eeee_tttt(3N), it exists in a name space (address family) but has no
  19.      name assigned.  _bbbb_iiii_nnnn_dddd() requests that the name pointed to by _n_a_m_e be
  20.      assigned to the socket.
  21.  
  22. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  23.      If the bind is successful, a 0 value is returned.  A return value of -1
  24.      indicates an error, which is further specified in the global _eeee_rrrr_rrrr_nnnn_oooo.
  25.  
  26. EEEERRRRRRRROOOORRRRSSSS
  27.      The _bbbb_iiii_nnnn_dddd() call will fail if:
  28.  
  29.      _EEEE_BBBB_AAAA_DDDD_FFFF               _s is not a valid descriptor.
  30.  
  31.      _EEEE_NNNN_OOOO_TTTT_SSSS_OOOO_CCCC_KKKK            _s is a descriptor for a file, not a socket.
  32.  
  33.      _EEEE_AAAA_DDDD_DDDD_RRRR_NNNN_OOOO_TTTT_AAAA_VVVV_AAAA_IIII_LLLL       The specified address is not available on the local
  34.                          machine.
  35.  
  36.      _EEEE_AAAA_DDDD_DDDD_RRRR_IIII_NNNN_UUUU_SSSS_EEEE          The specified address is already in use.
  37.  
  38.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL              _n_a_m_e_l_e_n is not the size of a valid address for the
  39.                          specified address family.
  40.  
  41.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL              The socket is already bound to an address.
  42.  
  43.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              The requested address is protected and the current
  44.                          user has inadequate permission to access it.
  45.  
  46.      _EEEE_NNNN_OOOO_SSSS_RRRR               There were insufficient STREAMS resources for the
  47.                          operation to complete.
  48.  
  49.      The following errors are specific to binding names in the UNIX domain:
  50.  
  51.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of the path prefix of the pathname in
  52.                          _n_a_m_e is not a directory.
  53.  
  54.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              A component of the path prefix of the pathname in
  55.                          _n_a_m_e does not exist.
  56.  
  57.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied for a component of the
  58.                          path prefix of the pathname in _n_a_m_e.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbiiiinnnndddd((((3333NNNN))))                                                              bbbbiiiinnnndddd((((3333NNNN))))
  71.  
  72.  
  73.  
  74.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links were encountered in
  75.                          translating the pathname in _n_a_m_e.
  76.  
  77.      _EEEE_IIII_OOOO                 An I/O error occurred while making the directory
  78.                          entry or allocating the inode.
  79.  
  80.      _EEEE_RRRR_OOOO_FFFF_SSSS               The inode would reside on a read-only file system.
  81.  
  82.      _EEEE_IIII_SSSS_DDDD_IIII_RRRR              A null pathname was specified.
  83.  
  84. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  85.      _uuuu_nnnn_llll_iiii_nnnn_kkkk(2)
  86.  
  87. NNNNOOOOTTTTEEEESSSS
  88.      Binding a name in the UNIX domain creates a socket in the file system
  89.      that must be deleted by the caller when it is no longer needed (using
  90.      _uuuu_nnnn_llll_iiii_nnnn_kkkk(2)).
  91.  
  92.      The rules used in name binding vary between communication domains.
  93.  
  94.      The type of address structure passed to _bbbb_iiii_nnnn_dddd() depends on the address
  95.      family.  UNIX domain sockets (address family _AAAA_FFFF______UUUU_NNNN_IIII_XXXX) require a _ssss_tttt_rrrr_uuuu_cccc_tttt
  96.      _ssss_oooo_cccc_kkkk_eeee_tttt_aaaa_dddd_dddd_rrrr______uuuu_nnnn as defined in _ssss_yyyy_ssss_////_uuuu_nnnn_...._hhhh; Internet domain sockets (address
  97.      family _AAAA_FFFF______IIII_NNNN_EEEE_TTTT) require a _ssss_tttt_rrrr_uuuu_cccc_tttt _ssss_oooo_cccc_kkkk_aaaa_dddd_dddd_rrrr______iiii_nnnn as defined in _nnnn_eeee_tttt_iiii_nnnn_eeee_tttt_////_iiii_nnnn_...._hhhh.
  98.      Other address families may require other structures.  Use the structure
  99.      appropriate to the address family; cast the structure address to a
  100.      generic _cccc_aaaa_dddd_dddd_rrrr______tttt in the call to _bbbb_iiii_nnnn_dddd() and pass the size of the structure
  101.      in the _llll_eeee_nnnn_gggg_tttt_hhhh argument.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.